home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / fish / 726-750 / 747 / aprf / aprf.doc < prev    next >
Text File  |  1995-03-18  |  43KB  |  1,095 lines
  1.  
  2.             APrf2 v1.40 - Manuel d'utilisation
  3.  
  4.  
  5.  
  6.  
  7.  
  8.     Ce manuel décrit la version 1.40 de l'utilitaire APrf2. Ce programme
  9. est (c)1989-1990-1991-1992 par Denis GOUNELLE, toute utilisation commerciale
  10. ou vente sans autorisation écrite est  strictement  interdite.    Vous  pouvez
  11. copier et diffuser ce programme aux conditions suivantes :
  12.  
  13.     - l'ensemble des fichiers doit être fourni
  14.     - aucun fichier ne doit avoir été modifié
  15.     - vous ne devez pas demander plus de 40FF pour cela
  16.  
  17.     "PowerPacker 2.3b" est (c)1989  par  PowerPeak  et  Nico  FRANCOIS,
  18. "PowerPacker Pro 3.0b" est (c)1990 par PowerPeak et par  UGA  Software.  La
  19. bibliothèque "powerpacker.library" est (c)1990 par Nico FRANCOIS. AREXX est
  20. (c)1987 par William Hawes. La bibliothèque "reqtools.library" est  (c)1990-
  21. 1991 par Nico FRANCOIS.
  22.  
  23.     Malgrès de nombreux tests, je ne peux garantir qu'APrf ne  contient
  24. aucune erreur. VOUS UTILISEZ CE PROGRAMME A VOS RISQUES ET  PERILS.  Je  ne
  25. pourrai en aucun cas être tenu    responsable  de  tout  dommage,  direct  ou
  26. indirect, résultant de l'utilisation d'APrf.
  27.  
  28.  
  29. Sommaire :
  30. ----------
  31.  
  32.     1. Introduction
  33.     2. Mode d'emploi
  34.        2.1 Appel depuis le CLI
  35.        2.2 Appel depuis le Workbench
  36.        2.3 Démarrage du programme
  37.        2.4 Les gadgets
  38.        2.5 Les menus
  39.        2.6 Entête et pied de page
  40.        2.7 La pré-visualisation
  41.        2.8 Modification de la sélection
  42.     3. Concepts avancés
  43.        3.1 La bibliothèque "powerpacker.library"
  44.        3.2 Le mode "eXpress"
  45.        3.3 Le mode AREXX
  46.        3.4 Le fichier "APrf.Init"
  47.     4. Gestion de la mémoire
  48.        4.1 Le fichier à imprimer
  49.        4.2 Le tampon de sortie
  50.        4.3 Mémoire nécessaire
  51.     5. Divers
  52.  
  53.  
  54. 1.Introduction :
  55. ----------------
  56.  
  57.     APrf2 est une nouvelle version    de  APrf,  capable  d'utiliser  les
  58. fonctions de la version 2.04 du système. Ce programme  peut  toujours  être
  59. utilisé avec le système 1.3, bien que certaines des nouvelles  possibilités
  60. ne soient pas disponibles dans ce cas.
  61.     APrf est un utilitaire d'impression de  fichiers  texte,  développé
  62. pour l'Amiga. Il permet entre autres l'ajout d'une entête ou d'un  pied  de
  63. page, l'ajout de marges,  la  numérotation  des  lignes,  l'impression  sur
  64. plusieurs  colonnes,  etc...  et  utilise  les    valeurs  fixées  dans    les
  65. Préférences. APrf dispose de plus  d'un  port  compatible  AREXX,  et  peut
  66. charger des fichiers compactés par "PowerPacker 2.3b" ou  par  "PowerPacker
  67. Pro 3.0b".
  68.  
  69.     Vous pouvez me faire part de vos remarques ou critiques  sur  APrf,
  70. en écrivant à l'adresse suivante :
  71.  
  72.               M. GOUNELLE Denis
  73.                   Boite 71
  74.              6, rue des cailloux
  75.             92110 CLICHY - FRANCE
  76.  
  77.     Merci à Serge  HAMMOUCHE, Jean-Yves PROUX,  Jean  ROUGELIN,  Michel
  78. SCHINZ, et Pierre VITET, pour leurs tests et leurs idées.
  79.  
  80.  
  81. 2. Mode d'emploi :
  82. ------------------
  83.  
  84.     APrf peut être lancé aussi bien depuis le Workbench que  depuis  le
  85. CLI. Dans ce dernier cas, il n'y  a  pas  besoin  d'utiliser  une  commande
  86. "RunBack" ou "ARun", car APrf se détache automatiquement de la fenêtre CLI.
  87.  
  88.  
  89.     2.1 Appel depuis le CLI :
  90.     -------------------------
  91.  
  92.     Depuis le CLI, on peut appeler APrf avec une  série  d'options  qui
  93. permettent de modifier les paramêtres par défaut. La syntaxe de la ligne de
  94. commande est :
  95.  
  96.         APrf [fichier][-c#][-d#][-e#][-f#,#][-g#][-n#][-p#][-t#][-vF]
  97.          [-x#][-A][-Cseq][-D#][-E{G|C|D}fmt][-F{G|C|D}][-Ifont]
  98.          [-N#][-Oopts][-P{p|e|f}][-Spages][-X]
  99.  
  100.     Si  on    précise l'argument <fichier>, le fichier correspondant sera
  101. considéré  comme  le  fichier  à imprimer.  Voici la description des autres
  102. options :
  103.  
  104.     -c#    (nombre de Colonnes)
  105.         Imprime sur # colonnes.
  106.         Valeur par défaut : # = 1.
  107.         Valeur minimale   : # = 1. Valeur maximale : # = 999.
  108.  
  109.     -d#    (marge Droite)
  110.         Ajoute    une  marge  droite de # caractères.  Notez que
  111.         les  marges fixées dans les Préférences sont prises en
  112.         compte quoi qu'il arrive.
  113.         Valeur par défaut : # = 0.
  114.         Valeur minimale   : # = 0. Valeur maximale : # = 999.
  115.  
  116.     -e#    (Espacement)
  117.         Sépare les colonnes par # espaces.
  118.         Valeur par défaut : # = 1.
  119.         Valeur minimale   : # = 1. Valeur maximale : # = 999.
  120.  
  121.     -f#,#    (Format de page)
  122.         Sélectionne le format de la page et les pages où faire
  123.         la présentation. Le premier # peut prendre les valeurs
  124.         suivantes :
  125.  
  126.             0 : pas de format particulier
  127.             1 : ajoute une entête
  128.             2 : ajoute un pied de page
  129.             3 : ajoute une entête et un pied de page
  130.  
  131.             Valeur par défaut : # = 1.
  132.  
  133.         Le second # peut prendre les valeurs suivantes :
  134.  
  135.             0 : sur toutes les pages
  136.             1 : sur toutes les pages sauf la première
  137.             2 : sur les pages paires
  138.             3 : sur les pages impaires
  139.  
  140.             Valeur par défaut : # = 0
  141.  
  142.         Il est possible de n'indiquer qu'un seul  paramètre  :
  143.         les formes "-f1,2", "-f1" et "-f,2" sont acceptées.
  144.         Pour plus de détails voir §2.6.
  145.  
  146.     -g#    (marge Gauche)
  147.         Ajoute    une  marge  gauche de # caractères.  Notez que
  148.         les  marges fixées dans les Préférences sont prises en
  149.         compte quoi qu'il arrive.
  150.         Valeur par défaut : # = 0.
  151.         Valeur minimale   : # = 0. Valeur maximale : # = 999.
  152.  
  153.     -n#    (Numérotation des lignes)
  154.         Numérote les lignes (numéros de # chiffres).
  155.         Valeur par défaut : # = 0 (pas de numéros de ligne).
  156.         Valeur minimale   : # = 0. Valeur maximale : # = 10.
  157.  
  158.     -p#    (longueur des Pages)
  159.         Imprime par pages de # lignes.
  160.         Valeur par défaut : "Paper Length" des Préférences.
  161.         Valeur minimale   : # = 5. Valeur maximale : # = 999.
  162.  
  163.     -t#    (Tabulation)
  164.         Règle  les  positions des tabulations sur les colonnes
  165.         #+1, 2#+1, 3#+1, etc...
  166.         Valeur par défaut : # = 8.
  167.         Valeur minimale   : # = 1. Valeur maximale : # = 999.
  168.  
  169.     -vF    (Vers)
  170.         L'impression est redirigée vers le fichier F.
  171.  
  172.     -x#    (eXemplaires)
  173.         Imprime # exemplaires du fichier.
  174.         Valeur par défaut : # = 1.
  175.         Valeur minimale   : # = 1. Valeur maximale : # = 999.
  176.  
  177.     -A    (mode AREXX)
  178.         Place APrf en mode AREXX (voir §3.3)
  179.  
  180.     -Cseq    (séquence de Contrôle)
  181.         Sélectionne la séquence de contrôle "seq" (voir §3.4).
  182.  
  183.     -D#    (format de la Date)
  184.         Indique le format de la date dans l'entête. # peut prendre
  185.         les valeurs :
  186.  
  187.             0 : format AmigaDOS (jj-mmm-aa)
  188.             1 : format international (aa-mm-jj)
  189.             2 : format américain (mm-jj-aa)
  190.             3 : format européen (jj-mm-aa)
  191.  
  192.         Valeur par défaut : # = 0.
  193.         Pour plus de détails voir §2.6.
  194.  
  195.     -E{G|C|D}fmt (format de l'Entête)
  196.         Indique le format de l'entête.
  197.         Pour plus de détails voir §2.6.
  198.  
  199.     -F{G|C|D}fmt (format du pied de page)
  200.         Indique le format du pied de page.
  201.         Pour plus de détails voir §2.6.
  202.  
  203.     -Ifont    (police Interne)
  204.         Sélectionne la police interne indiquée.
  205.         Pour plus de détails voir §3.4.
  206.  
  207.     -N#    (Numéro de la première page)
  208.         La numérotation des pages commence au nombre #.
  209.         Valeur par défaut : # = 1.
  210.         Valeur minimale   : # = 1. Valeur maximale : # = 899.
  211.  
  212.     -Oopts    (Options)
  213.         Permet de modifier certaines options. opts est une
  214.         combinaison quelconque des caractères :
  215.  
  216.             c    qualité courrier
  217.             l    qualité listing
  218.             8    interligne 8LPI
  219.             6    interligne 6LPI
  220.             C    alimentation papier continu
  221.             F    alimentation feuilles à feuilles
  222.             t    tronque les lignes trop longues
  223.             f    filtre les caractères de contrôle
  224.             a    filtre les séquences d'échappement
  225.             k    tampon de sortie d'un kilo-octets
  226.             n    n'envoit pas de sauts de page
  227.             u    souligne l'entête
  228.  
  229.         Voir la description du menu "Options" au §2.5 pour plus
  230.         de détails.
  231.  
  232.     -P{p|e|f} (Pas d'impression)
  233.         Permet de sélectionner le pas d'impression :
  234.  
  235.             -Pp pour le pas "pica"
  236.             -Pe pour le pas "elite"
  237.             -Pf pour le pas "fine"
  238.  
  239.         Valeur par défaut : "Pitch" des Préférences.
  240.  
  241.     -Spages (Sélection)
  242.         Permet    de  sélectionner  les  pages  à  imprimer.  La
  243.         sélection peut prendre les formes suivantes :
  244.  
  245.             x      : page x uniquement
  246.             x-y      : pages x à y
  247.             x,y,z,... : pages x,y,z,...
  248.  
  249.         Vous pouvez également utiliser une combinaisons des deux
  250.         dernières formes, comme par exemple "-S1,3,5-8".
  251.  
  252.         ATTENTION : les numéros de page indiqués dans la sélection
  253.                 doivent tenir compte du numéro de la  première
  254.                 page (voir option -N)
  255.  
  256.     -X    (eXpress)
  257.         Lance APrf en mode eXpress (voir §3.2).
  258.  
  259.  
  260.     En cas d'erreur dans la ligne de commande, une fenêtre apparait sur
  261. l'écran Workbench, portant le message "Arguments incorrects".  Cliquez  sur
  262. le gadget "OK" (ou appuyez sur  Amiga-V)  pour  la  faire  disparaitre,  et
  263. relancez APrf après correction de la ligne de commande.
  264.     Notez que le menu "Outils"  possède  une  commande  qui  permet  de
  265. savoir quelles options de la ligne de commande    correspondent  aux  options
  266. courantes (voir §2.5 pour plus de détails).
  267.  
  268.  
  269.     2.2 Appel depuis le Workbench :
  270.     -------------------------------
  271.  
  272.     Il y a trois façon d'appeler APrf depuis le Workbench quand on veut
  273. lui indiquer le ou les fichiers à imprimer :
  274.  
  275.      - en double-cliquant sur une icône de  type  "Project"  qui  a  APrf
  276.        comme outil par défaut ("Default tool")
  277.      - en cliquant sur une  ou    plusieurs  icônes  de  fichiers  puis  en
  278.        double-cliquant sur l'icône d'APrf tout en gardant la touche SHIFT
  279.        enfoncée.
  280.      - en cliquant sur l'icône d'APrf (et éventuellement sur  des  icônes
  281.        de fichiers) puis en double-cliquant sur une icône de fichier tout
  282.        en gardant la touche SHIFT enfoncée.
  283.  
  284.     Dans tous les cas, le ou les fichiers sélectionnés sont transmis  à
  285. APrf, qui affiche le nom du premier  fichier  dans  le    gadget    "Fichier  à
  286. imprimer" (voir §2.4). La  commande  "Fichier  suivant"  du  menu  "Projet"
  287. permet de passer au fichier suivant (voir §2.5), et  la  commande  "Options
  288. défaut" du menu "Outils" permet de revenir au premier fichier de  la  liste
  289. (voir §2.5).
  290.  
  291.     Comme pour l'appel depuis le CLI, il est  possible  d'appeler  APrf
  292. avec des options. Pour ce faire, cliquez sur l'icône du fichier à imprimer,
  293. appelez le menu "Icons" du Workbench et  choisissez  l'item  "Information".
  294. Ensuite, cliquez sur le gadget "New" de la zone "TOOL TYPES" et entrez  les
  295. options en respectant la syntaxe suivante :
  296.  
  297.       APRF=[-c#][-d#][-e#][-f#,#][-g#][-n#][-p#][-t#][-vF][-x#]
  298.            [-Cseq][-D#][-E{G|C|D}fmt][-F{G|C|D}][-Ifont][-N#]
  299.            [-Oopts][-P{p|e|f}][-Spages]
  300.  
  301.     Ces options sont décrites au paragraphe précédent (§2.1).  Si  vous
  302. appelez APrf depuis le Workbench sans arguments (juste  en  double-cliquant
  303. sur l'icône d'APrf) les options seront cherchées dans le champ "TOOL TYPES"
  304. de l'icône d'APrf.
  305.     Notez que les options -A (mode  AREXX)  et  -X  (mode  eXpress)  ne
  306. peuvent être utilisées en cas d'appel depuis le Workbench.
  307.  
  308.  
  309.     2.3 Démarrage du programme :
  310.     ----------------------------
  311.  
  312.     APrf utilise la version 2.0c de la bibliothèque "reqtools.library".
  313. Vous devez donc copier cette bibliothèque dans le répertoire "LIBS:", si ce
  314. n'est déjà fait.
  315.  
  316.     Si  tout  se  passe bien, un écran s'ouvre, sur lequel apparaissent
  317. une vingtaine de gadgets. Sinon une fenêtre apparait sur l'écran Workbench,
  318. indiquant le problème rencontré. Cliquez sur le gadget "OK" (ou appuyez sur
  319. Amiga-V) pour la faire disparaitre, APrf s'arrête et retourne la valeur  10
  320. (ERROR, voir commande IF de l'AmigaDOS).
  321.  
  322.     Il  se peut que APrf rende la main sans dire pourquoi, c'est-à-dire
  323. sans afficher aucun message, mais en retournant  cependant  la    valeur    10.
  324. Ceci ne peut se produire que dans quatre cas :
  325.  
  326.     a) APrf n'a pu ouvrir la bibliothèque "intuition.library"
  327.     b) APrf n'a pu ouvrir la bibliothèque "graphics.library"
  328.     c) APrf n'a pu ouvrir la fenêtre pour afficher le message d'erreur
  329.     d) APrf n'a pu ouvrir l'écran Workbench
  330.  
  331.     Il est cependant fort peu probable  que  vous  soyez  confrontés  à
  332. cette situation.
  333.  
  334.     Je suppose maintenant que le programme a démarré correctement.    Les
  335. deux  paragraphes  qui    suivent  vont  vous  expliquer comment utiliser les
  336. gadgets et les menus d'APrf. Si vous utilisez APrf pour la  première  fois,
  337. je vous conseille de lancer  le  programme afin de pouvoir mieux suivre les
  338. explications.
  339.  
  340.  
  341.     2.4 Les gadgets :
  342.     -----------------
  343.  
  344.     Ce paragraphe décrit les gadgets affichés sur l'écran, de  haut  en
  345. bas et de gauche à droite.
  346.  
  347.     Fichier à imprimer :
  348.  
  349.         Ce gadget indique le nom du fichier à imprimer.
  350.         Pour modifier sa valeur il suffit de  cliquer  dessus.    Une
  351.         boite de requête apparait, vous permettant  de    choisir  le
  352.         fichier à imprimer. Si vous cliquez sur le gadget "CANCEL",
  353.         ou sur    le  gadget  "OK"  sans  avoir  choisi  de  fichier,
  354.         l'ancien nom de fichier sera conservé.
  355.         Le caractère "*" apparait à droite du nom de fichier  quand
  356.         le fichier est chargé en mémoire (voir §4.1).
  357.  
  358.     Fichier de sortie :
  359.  
  360.         Ce gadget indique où sera envoyée l'impression.
  361.         Par  défaut  il indique "PRT:", mais cette valeur peut être
  362.         changée à l'appel grâce à l'option -v (voir §2.1).
  363.         Pour modifier la valeur de ce gadget, il suffit de  cliquer
  364.         dessus. Une boite de requête apparait, vous  permettant  de
  365.         choisir le fichier de sortie. Si vous cliquez sur "CANCEL",
  366.         le fichier de sortie devient "PRT:".
  367.  
  368.     Pages sélectionnées :
  369.  
  370.         Ce gadget indique quelles pages  seront  imprimées.
  371.         Par défaut il indique "*",  ce  qui  signifie  "toutes  les
  372.         pages", mais cette valeur peut être changée à l'appel grâce
  373.         à l'option -S (voir §2.1).
  374.         Pour modifier la valeur de la sélection,  reportez-vous  au
  375.         §2.8.
  376.  
  377.     Les neufs gadgets suivants permettent de spécifier respectivement :
  378. la taille de la marge gauche, la taille de la marge droite, la longueur des
  379. tabulations, le nombre de lignes par page, le numéro de la  première  page,
  380. la taille des numéros de lignes, le nombre de  colonnes,  l'espacement  des
  381. colonnes, et le nombre d'exemplaires à imprimer.
  382.     Chacun    de  ces gadgets indique la  valeur  actuelle  du  paramêtre
  383. correspondant, suivit par une flèche vers le haut et  une  flèche  vers  le
  384. bas. Vous pouvez cliquer sur la valeur, et la modifier au clavier  (appuyez
  385. sur Amiga-X pour effacer la valeur précédente, n'oubliez pas d'appuyer  sur
  386. <RETURN> pour valider la nouvelle valeur). Vous  pouvez  également  cliquez
  387. sur la flèche vers le haut pour augmenter la valeur, ou sur la flèche  vers
  388. le bas pour la réduire. Si la valeur ne change pas,  c'est  que  vous  avez
  389. atteind la limite inférieure ou supérieure admise  pour  ce  paramêtre.  La
  390. valeur augmente ou diminue automatiquement tant que  vous  appuyez  sur  le
  391. bouton gauche de la souris.
  392.  
  393.     Marge gauche : (voir §2.1, option -g)
  394.         Valeur par défaut : 0
  395.         Valeur minimale   : 0
  396.         Valeur maximale   : 999
  397.  
  398.     Marge droite : (voir §2.1, option -d)
  399.         Valeur par défaut : 0
  400.         Valeur minimale   : 0
  401.         Valeur maximale   : 999
  402.  
  403.     Tabulation : (voir §2.1, option -t)
  404.         Valeur par défaut : 8
  405.         Valeur minimale   : 1
  406.         Valeur maximale   : 999
  407.  
  408.     Lignes par page : (voir §2.1, option -p)
  409.         Valeur par défaut : "Paper length" des Préférences
  410.         Valeur minimale   : 5
  411.         Valeur maximale   : 999
  412.  
  413.     No première page : (voir §2.1, option -N)
  414.         Valeur par défaut : 1
  415.         Valeur minimale   : 1
  416.         Valeur maximale   : 899
  417.  
  418.         NOTE : la sélection des pages est effacée à chaque
  419.                modification du numéro de la première page.
  420.  
  421.     No de lignes : (voir §2.1, option -n)
  422.         Valeur par défaut : 0 (pas de numéros de ligne)
  423.         Valeur minimale   : 0 (pas de numéros de ligne)
  424.         Valeur maximale   : 10
  425.  
  426.     Colonnes : (voir §2.1, option -c)
  427.         Valeur par défaut : 1
  428.         Valeur minimale   : 1
  429.         Valeur maximale   : 999
  430.  
  431.     Espacement : (voir §2.1, option -e)
  432.         Valeur par défaut : 1
  433.         Valeur minimale   : 1
  434.         Valeur maximale   : 999
  435.  
  436.     Exemplaires : (voir §2.1, option -x)
  437.         Valeur par défaut : 1
  438.         Valeur minimale   : 1
  439.         Valeur maximale   : 999
  440.  
  441.     Les cinq gadgets suivants proposent différentes valeurs, que vous
  442. pouvez faire défiler en cliquant sur le gadget en forme de  flèche  affiché
  443. juste à droite de la valeur.
  444.  
  445.     Caractères :
  446.  
  447.         Ce gadget indique le pas d'impression. Par défaut,  le  pas
  448.         est celui indiqué dans le champ  "Pitch"  des  Préférences,
  449.         mais cela peut être changé à l'appel grâce  à  l'option  -P
  450.         (voir §2.1).
  451.  
  452.     Police :
  453.  
  454.         Ce gadget indique la police interne à utiliser. Normalement
  455.         il s'agit de la police par  défaut,  mais  cela  peut  être
  456.         changé à l'appel grâce à l'option -I (voir §2.1).
  457.         Pour plus de détails, voir §3.4.
  458.  
  459.     Format Date :
  460.  
  461.         Ce gagdet indique dans quel format sera la date. Par défaut
  462.         le format est le  format  AmigaDOS,  mais  ceci  peut  être
  463.         changé à l'appel grâce à l'option -D (voir §2.1).
  464.         Pour plus de détails, voir §2.6.
  465.  
  466.     Format Page :
  467.  
  468.         Ce gadget indique le format de page courant
  469.         Par défaut le format est  "entête",  mais  ceci  peut  être
  470.         changé à l'appel grâce à l'option -f (voir §2.1).
  471.         Pour plus de détails, voir §2.6.
  472.  
  473.     sur :
  474.  
  475.         Ce gadget indique sur quelles pages seront ajoutés l'entête
  476.         et/ou le pied de page.
  477.         Par défaut, ce sera sur toutes les pages,  mais  ceci  peut
  478.         être changé à l'appel grâce à l'option -f (voir §2.1).
  479.         Pour plus de détails, voir §2.6.
  480.  
  481.     Les gadgets suivants vous permettent de personnaliser  l'entête  et
  482. le pied de page.
  483.  
  484.     Entête :
  485.  
  486.         Ce gadget indique le format des trois parties de l'entête :
  487.         la partie gauche, la partie centrale, et la partie  droite.
  488.         La valeur par défaut de chaque partie peut être  changée  à
  489.         l'appel grâce à l'option -E (voir §2.1).
  490.         Pour modifier la valeur d'une des parties, il  vous  suffit
  491.         de cliquer dessus : une   fenêtre   avec   un    gadget     de
  492.         chaine apparait alors. Appuyez sur Amiga-X pour effacer  la
  493.         valeur, sur RETURN pour valider, ou cliquez sur  le  bouton
  494.         de fermeture pour annuler l'opération.
  495.         Pour plus de détails, voir §2.6.
  496.  
  497.     Pied de page :
  498.  
  499.         Fonctionne de la même façon que pour  l'entête.  La  valeur
  500.         par défaut peut être changée à l'appel grâce à l'option  -F
  501.         (voir §2.1).
  502.         Pour plus de détails, voir §2.6.
  503.  
  504.     Les deux gadgets en forme de losange, en bas de l'écran, permettent
  505. de lancer l'impression (celui de gauche) et de lancer la  pré-visualisation
  506. (celui de droite) sans avoir à passer par les menus.
  507.     Vous pouvez également cliquer sur le  gadget  de  fermeture  de  la
  508. fenêtre principale (en haut à gauche) pour quitter le programme, ou sur  le
  509. gadget "zoom" (en haut à droite) pour iconifier APrf.
  510.  
  511.  
  512.     2.5 Les menus :
  513.     ---------------
  514.  
  515.     APrf possède trois menus : le menu "Projet", le menu "Outils" et le
  516. menu "Options". Chaque commande peut  être  sélectionnée  à  l'aide  de  la
  517. souris ou de raccourcis clavier, par contre les items du menu "Options"  ne
  518. peuvent être modifiés qu'à la souris. Les rubriques du menu  "Projet"  sont
  519. les suivantes :
  520.  
  521.     Commande "Fichier suivant" (Amiga-F) :
  522.  
  523.         Si l'on a appelé APrf depuis le Workbench en  sélectionnant
  524.         plusieurs fichiers, cette  commande  permet  de  passer  au
  525.         fichier suivant dans la liste des fichiers sélectionnés.
  526.         Le gadget "Fichier à imprimer" est mis à jour  (voir  §2.4)
  527.         et l'ancien fichier est vidé  de  la  mémoire  (s'il  était
  528.         chargé, voir §4.1).
  529.  
  530.     Commande "Imprime" (Amiga-P) :
  531.  
  532.         Lance l'impression.
  533.  
  534.     Commande "Mode AREXX" (Amiga-A) :
  535.  
  536.         Place APrf en mode AREXX (voir §3.3).
  537.         Une  boite  de    requête  apparaitra  pour   vous   demander
  538.         confirmation, cliquez sur "OUI" ou appuyez sur Amiga-V pour
  539.         passer en mode    AREXX, cliquez sur  "NON"  ou  appuyez  sur
  540.         Amiga-B pour rester en mode normal.
  541.  
  542.     Commande "Palette" :
  543.  
  544.         Vous permet de modifier les couleurs de l'écran de APrf.
  545.         Pour sauvegarder la nouvelle palette immédiatement, appelez
  546.         la commande "Sauve config" et entrez "palette" comme nom de
  547.         configuration.    Sinon,    lorsque  vous  voudrez    quitter  le
  548.         programme, APrf vous demandera si  vous  voulez  sauver  la
  549.         nouvelle palette.
  550.  
  551.     Commande "A Propos..." (Amiga-?) :
  552.  
  553.         Affiche  quelques  informations  sur   APrf.   Pour   faire
  554.         disparaitre la fenêtre, cliquez à  l'intérieur  ou  appuyez
  555.         sur une touche.
  556.  
  557.     Commande "Iconifie" (Amiga-I) :
  558.  
  559.         Iconifie APrf. L'écran d'APrf  est  fermé,  et  une  petite
  560.         fenêtre dont le titre est "APrf2  v1.40"  vient  se  placer
  561.         dans le coin supérieur gauche de l'écran Workbench.
  562.         Pour réveiller    APrf,  rendez  cette  fenêtre  active  puis
  563.         cliquez sur le bouton droit de la souris.
  564.         Vous pouvez quitter APrf lorsqu'il est iconifié sans  avoir
  565.         à le réveiller, en cliquant sur le gadget de  fermeture  de
  566.         la petite fenêtre.
  567.  
  568.     Commande "Quitte" (Amiga-Q ou ESCAPE) :
  569.  
  570.         Termine l'exécution d'APrf.
  571.         Une  boite  de    requête  apparaitra  pour   vous   demander
  572.         confirmation, cliquez sur "OUI" ou appuyez sur Amiga-V pour
  573.         quitter, cliquez sur "NON" ou appuyez sur Amiga-B  pour  ne
  574.         pas quitter APrf.
  575.  
  576.  
  577.     Voici la description des commandes du menu "Outils" :
  578.  
  579.     Commande "Options défaut" (Amiga-D) :
  580.  
  581.         Permet de recharger les options par défaut (dans l'ordre  :
  582.         valeurs des  Préférences,  puis  options  de  la  ligne  de
  583.         commande).
  584.         Si l'on a appelé APrf depuis le Workbench en  sélectionnant
  585.         plusieurs fichiers, le premier fichier sélectionné  devient
  586.         le fichier à imprimer.
  587.         Cette commande peut être utile (entre autres) si vous  avez
  588.         changé les Préférences, car cela permet à APrf    de  prendre
  589.         en compte ces modifications sans que vous ayez à quitter le
  590.         programme.
  591.  
  592.     Commande "Charge fichier" (Amiga-C) :
  593.  
  594.         Permet de charger immédiatement le fichier  à  imprimer  en
  595.         mémoire. Si ce    fichier  était    déjà  en  mémoire,  il    est
  596.         rechargé quand même (voir §4.1).
  597.  
  598.     Commande "Libère fichier" (Amiga-L) :
  599.  
  600.         Permet de libérer la  mémoire  occupée    par  le  fichier  à
  601.         imprimer (voir §4.1)
  602.  
  603.     Commande "Pré-visualise" (Amiga-V) :
  604.  
  605.         Permet de visualiser la mise en page du fichier à imprimer.
  606.         (voir §2.7).
  607.  
  608.     Commande "Ligne de cmd" (Amiga-K) :
  609.  
  610.         Affiche la liste des options à donner à  l'appel  pour  que
  611.         les paramêtres d'impressions aient leur valeur actuelle.
  612.         Pour faire disparaitre la fenêtre, cliquez à l'intérieur ou
  613.         appuyez sur une touche.
  614.  
  615.     Commande "Sauve config" (Amiga-S) :
  616.  
  617.         Sauve les options courantes  (sauf  le  nom  du  fichier  à
  618.         imprimer) en créant une  nouvelle  ligne  dans    le  fichier
  619.         "S:APrf.Init". Une fenêtre apparait, et vous  devez  entrer
  620.         le nom de la nouvelle configuration. Cliquez sur le  gadget
  621.         de fermeture de la fenêtre pour annuler l'opération.  Notez
  622.         que le nouveau fichier de configuration n'est pas rechargé.
  623.         Voir §3.4 pour d'autres détails.
  624.  
  625.     Commande "Doc info" (Amiga-X) :
  626.  
  627.         Affiche le nombre de pages, de lignes et de caractères    que
  628.         produira l'impression courant. Ce décompte tient compte  de
  629.         toutes les options de mise  en    page,  mais  notez  que  le
  630.         nombre de caractères est approximatif.
  631.         Pour faire disparaitre la fenêtre, cliquez sur le gadget
  632.         "OK" ou appuyez sur Amiga-V.
  633.  
  634.  
  635.     Voici la description des items du menu "Options" :
  636.  
  637.     Option "Courrier" :
  638.  
  639.         Permet de sélectionner la qualité d'impression : "courrier"
  640.         ou "listing".
  641.         Par défaut la qualité  est  celle  indiquée  par  le  champ
  642.         "Print Quality" des Preferences, mais cela peut être changé
  643.         à l'appel par l'option -O (voir §2.1).
  644.  
  645.     Option "8 LPI" :
  646.  
  647.         Permet de régler l'interligne : "8 LPI" ou "6 LPI".
  648.         Par défaut l'interligne est  celui  indiqué  par  le  champ
  649.         "Spacing" des Préférences, mais cela  peut  être  changé  à
  650.         l'appel par l'option -O (voir §2.1).
  651.  
  652.     Option "Continu" :
  653.  
  654.         Permet d'indiquer comment est alimentée votre imprimante  :
  655.         par du papier en continu, ou feuille à feuille.
  656.         Par défaut, l'alimentation est celle indiquée par le  champ
  657.         "Paper type" des Préférences, mais cela peut être changé  à
  658.         l'appel grâce à l'option -O (voir §2.1).
  659.  
  660.     Option "Tronque" :
  661.  
  662.         Si cette option est active, les lignes trop longues  seront
  663.         tronquées au lieu d'être imprimées sur plusieurs lignes.
  664.         Normalement cette option n'est pas active, mais  cela  peut
  665.         être changé à l'appel grâce à l'option -O (voir §2.1).
  666.  
  667.     Option "Filtre CTRL" :
  668.  
  669.         Si cette option est  active,  les  caractères  de  contrôle
  670.         (code ASCII inférieur à 32 ou supérieur à 126) trouvés dans
  671.         le fichier à imprimer ne seront pas envoyés à l'imprimante.
  672.         Normalement cette option n'est pas active, mais  cela  peut
  673.         être changé à l'appel grâce à l'option -O (voir §2.1).
  674.  
  675.     Option "Filtre ANSI" :
  676.  
  677.         Si cette option est active, les séquence d'échappement ANSI
  678.         (définies au §6) trouvées dans le  fichier  à  imprimer  ne
  679.         seront pas envoyés à l'imprimante.
  680.         Normalement cette option n'est pas active, mais  cela  peut
  681.         être changé à l'appel grâce à l'option -O (voir §2.1).
  682.  
  683.     Option "Tampon 1Ko" :
  684.  
  685.         Si cette option est active, le tampon de  sortie  aura    une
  686.         taille d'un kilo-octets (et non d'une page).
  687.         Normalement cette option n'est pas active, mais  cela  peut
  688.         être changé à l'appel grâce à l'option -O (voir §2.1).
  689.         Voir §4.2 pour plus de détails.
  690.  
  691.     Option "Envoie FF" :
  692.  
  693.         Si cette option est active, un    caractère  "saut  de  page"
  694.         (Form Feed) est envoyé à la fin de chaque page.
  695.         Normalement cette option est active, mais  cela  peut  être
  696.         changé à l'appel grâce à l'option -O (voir §2.1).
  697.  
  698.     Option "Soul.entête" :
  699.  
  700.         Si cette option est active, l'entête sera souligné lors  de
  701.         l'impression.
  702.         Normalement cette option n'est pas active, mais  cela  peut
  703.         être changé à l'appel grâce à l'option -O (voir §2.1).
  704.  
  705.  
  706.     2.6 L'entête et le pied de page :
  707.     ---------------------------------
  708.  
  709.     APrf vous permet d'ajouter une entête, un  pied  de  page,  ou  les
  710. deux, sur vos documents. Le choix se fait soit à l'appel (option  -f,  voir
  711. §2.1) soit avec le gadget "Format Page" (voir §2.4). L'entête et le pied de
  712. page utilisent chacun deux lignes sur la page.
  713.  
  714.     Lorsque vous demandez une entête (et/ou  un  pied  de  page),  APrf
  715. utilise la valeur des gadgets "Entête" (et/ou "Pied de page") pour composer
  716. cette entête (et/ou ce pied de page). Le gadget à  gauche  indique  ce  qui
  717. sera écrit à gauche, le gadget central ce qui sera écrit au milieu,  et  le
  718. gadget à droite ce qui sera écrit à droite.
  719.     Les  spécifications  de  format  peuvent  utiliser  les   séquences
  720. suivantes :
  721.  
  722.     %a    nom du jour de la semaine (e.g. "Lundi")
  723.     %b    nom du mois (complet, e.g. "septembre")
  724.     %B    nom du mois (abbrégé, e.g. "Sep")
  725.     %d    jour du mois (01 à 31)
  726.     %D    date telle qu'indiquée par le gadget "Format Date"
  727.     %f    nom de base du fichier (e.g. "toto")
  728.     %F    nom complet du fichier (e.g. "RAM:titi/toto")
  729.     %h    heure (00 à 11)
  730.     %H    heure (00 à 23)
  731.     %m    mois (01 à 12)
  732.     %M    minutes (00 à 59)
  733.     %n    numéro de page
  734.     %p    période de la journée (AM ou PM)
  735.     %s    taille du fichier en octets
  736.     %S    secondes (00 à 59)
  737.     %v    version du programme (e.g. "APrf v4.20")
  738.     %w    jour de la semaine (0 à 6)
  739.     %x    numéro d'exemplaire
  740.     %y    année (00 à 99)
  741.  
  742.     La valeur par défaut de l'entête est "%f" pour  la  partie  gauche,
  743. "Page %n" pour la partie centrale, et "%D" pour la partie droite. La valeur
  744. par défaut du pied de page est "Page %n" pour la partie centrale,  et  rien
  745. pour les autres parties.
  746.     Vous avez  la  possibilité  d'indiquer  un  format  différent  pour
  747. l'entête  (et/ou  le  pied  de  page),  soit  en  cliquant  sur  le  gadget
  748. correspondant à la partie que vous voulez modifier,  soit  à  l'appel  avec
  749. l'option -E (et/ou l'option -F) : "-EGformat" modifie la valeur par  défaut
  750. de  la    partie    gauche,  "-ECformat"  celle  de  la  partie  centrale,   et
  751. "-EDformat" celle de la partie droite.
  752.     Vous pouvez également préciser sur quelles pages doivent apparaitre
  753. l'entête (et/ou le pied de page), soit avec le gadget  "sur"  (voir  §2.4),
  754. soit à l'appel à l'aide de l'option -f (voir §2.1).
  755.  
  756.  
  757.     2.7 La pré-visualisation :
  758.     --------------------------
  759.  
  760.     Cette fonction vous permet de  voir  l'aspect  final  du  texte  en
  761. fonction des options de mise en page.  Pour  l'utiliser,  réglez  tous  les
  762. paramêtres d'impression, puis choisissez  la  commande  "Pré-visualise"  du
  763. menu "Outils". Une fenêtre apparait au milieu de l'écran, et vous montre le
  764. résultat de la mise en page en commençant par la première page sélectionnée
  765. (la taille de la fenêtre est fonction de la taille de la page).
  766.     Pour passer à  la  page  suivante,  cliquez  à    l'intérieur  de  la
  767. fenêtre, ou appuyez sur la touche RETURN. A tout moment vous pouvez arrêter
  768. l'opération de visualisation en cliquant sur le gadget de fermeture  ou  en
  769. appuyant sur la touche ESCAPE.
  770.  
  771.     Notez cependant que si la longueur des pages est très grande  (plus
  772. de 121 lignes en mode PAL, ou plus de 93 lignes  en  mode  NTSC),  APrf  ne
  773. pourra pas ouvrir la fenêtre de pré-visualisation.
  774.  
  775.  
  776.     2.8 Modification de la sélection
  777.     --------------------------------
  778.  
  779.     Pour modifier la sélection des pages à    imprimer,  cliquez  sur  le
  780. gadget "Pages sélectionnées". Une fenêtre apparaitra au milieu de  l'écran.
  781. La partie supérieure de cette fenêtre est une grille de 100 cases, dont les
  782. numéros correspondent aux numéros de pages. Les numéros sont écrits en noir
  783. sur blanc si la page correspondante est sélectionnée, en noir sur bleu dans
  784. le cas contraire.
  785.     Si vous cliquez sur un numéro, vous inverserez la sélection  de  la
  786. page correspondante. Vous avez également à votre  disposition  les  gadgets
  787. suivants :
  788.  
  789.     TOUT        sélectionne toutes les pages
  790.     INVERSER    inverse la sélection
  791.     RIEN        aucune page n'est sélectionnée
  792.     VALIDER     validation de la nouvelle sélection (ou RETURN)
  793.     REPRENDRE   reprise de la sélection précédente
  794.     ANNULER     annulation de la nouvelle sélection (ou ESCAPE)
  795.  
  796.     Vous pouvez également utiliser le gadget de chaine  pour  spécifier
  797. de nouvelles pages à sélectionner (en plus de celles qui le sont déjà). Les
  798. valeurs admises dans ce gadget sont :
  799.  
  800.     *        toutes les pages
  801.     x        page x uniquement
  802.     x-y        pages x à y
  803.     x,y,z,...   pages x,y,z,...
  804.  
  805.     Vous pouvez utiliser une combinaisons des  deux  dernières  formes,
  806. comme par exemple "1,3,5-8".
  807.  
  808.     N'oubliez pas que la sélection dépend  du  numéro  de  la  première
  809. page. Notez enfin  que    vous  ne  pourrez  valider  si    aucune    page  n'est
  810. sélectionnée.
  811.  
  812.  
  813. 3. Concepts avancés :
  814. ---------------------
  815.  
  816.     Ce chapitre décrit quelques  possibilités  supplémentaires  d'APrf,
  817. qui lui permettront de s'intégrer encore mieux dans votre environnement  de
  818. travail.
  819.  
  820.  
  821.     3.1 La bibliothèque "powerpacker.library" :
  822.     -------------------------------------------
  823.  
  824.     APrf utilise la bibliothèque  "powerpacker.library",  si  elle  est
  825. présente dans le répertoire LIBS: de votre disquette Workbench ou de  votre
  826. disque dur. Ceci vous permet de demander l'impression d'un fichier compacté
  827. par les logiciels "PowerPacker 2.3b" ou "PowerPacker Pro 3.0b" : le fichier
  828. sera automatiquement décompacté lors de son chargement. Si le fichier avait
  829. été crypté, APrf vous demandera le mot de passe nécessaire à son décodage.
  830.  
  831.  
  832.     3.2 Le mode "eXpress" :
  833.     -----------------------
  834.  
  835.     Il se peut, dans certains cas, que vous ayez  envie  d'imprimer  un
  836. fichier rapidement, sans faire appel à l'interface Intuition d'APrf (si vos
  837. Préférences sont réglées correctement c'est sans  doute  souvent  le  cas).
  838. Dans ce but, l'option -X a été ajouté à APrf : en présence de cette option,
  839. une fois la ligne de commande analysée, l'impression  démarre  directement.
  840. APrf n'ouvre pas d'écran, et s'arrête une fois  l'impression  achevée.  Les
  841. messages d'erreur éventuels sont affichés sur l'écran Workbench,  dans  une
  842. fenêtre spéciale.
  843.  
  844.  
  845.     3.3 Le mode AREXX :
  846.     -------------------
  847.  
  848.     Si vous indiquez l'option -A lors de l'appel d'APrf, celui-ci passe
  849. en mode AREXX : un port compatible AREXX nommé "APrf_rexx" est  ouvert,  et
  850. le programme attend des messages sur ce port. L'emploi de l'option -A  fait
  851. obligatoirement passer APrf en mode "eXpress" (voir §3.2).
  852.  
  853.     Les messages peuvent être :
  854.  
  855.     quit   : APrf ferme le port AREXX et termine
  856.     wakeup : APrf ferme le port AREXX et lance l'interface Intuition
  857.     reset  : APrf recharge les Préférences et revient aux options par
  858.          défaut
  859.     load   : APrf charge en mémoire le fichier à imprimer
  860.     print  : APrf lance l'impression
  861.  
  862.     Tout autre message est considéré comme une ligne  de  commande    CLI
  863. et analysé de la même manière (voir §2.1 pour la syntaxe). En cas  d'erreur
  864. APrf affiche un message sur l'écran Workbench, dans une  fenêtre  spéciale,
  865. et termine.
  866.     Si vous envoyez un message "load" sans avoir auparavant indiqué  le
  867. nom du fichier à imprimer, la commande restera sans effet.
  868.  
  869.     Voici un exemple de programme  AREXX,  qui  lance  l'impression  du
  870. fichier S:Startup-Sequence avec une marge gauche  de  10  caractères,  puis
  871. termine APrf :
  872.  
  873.     /* Imprime S:Startup-Sequence */
  874.     address "APrf_rexx"
  875.     "S:Startup-Sequence -g10"
  876.     "print"
  877.     "quit"
  878.  
  879.     Notez les guillemets autour des commandes !
  880.  
  881.     Depuis l'interface Intuition, vous pouvez placer APrf en mode AREXX
  882. à l'aide de la commande "Mode AREXX" du menu "Projet" (voir §2.5).
  883.  
  884.  
  885.     3.4 Le fichier "APrf.Init" :
  886.     ----------------------------
  887.  
  888.     Lors du démarrage, APrf essaye d'accéder au fichier  "S:APrf.Init".
  889. Ce fichier vous  permet  de  définir  des  configurations  type  et/ou    des
  890. polices. Dans le premier cas, les lignes du fichier doivent avoir le format
  891. suivant :
  892.  
  893.     nom:options:séquence
  894.  
  895. où "nom" et "options" sont des suites de  caractères  quelconques  (il  est
  896. conseillé de ne pas dépasser 8 caractères pour "nom"),  et  "séquence"  est
  897. une suite de code décimaux, séparés par des espaces. Les parties  "options"
  898. et "séquence" peuvent être vides. Seules  les  8  premières  configurations
  899. type sont prises en compte. Voici quelques exemples de lignes :
  900.  
  901.     mon8lpi:-p90 -O8:
  902.     landscap:-p80:27 48 108 72
  903.  
  904.     Chaque nom indiqué apparaitra  dans  un  nouveau  menu    :  le  menu
  905. "Contrôle". Si vous sélectionnez un nom dans ce menu, la  chaine  "options"
  906. sera immédiatement analysée comme une ligne de commande CLI. De plus,  lors
  907. de l'impression, les caractères dont le code  ASCII  est  indiqué  dans  la
  908. séquence correspondante seront envoyées à l'imprimante (après les séquences
  909. normales d'initialisation, mais avant le texte lui-même). Vous pouvez  bien
  910. entendu sélectionner plusieurs noms en même temps.
  911.     Lors d'un appel depuis le CLI ou depuis le Workbench,  l'option  -C
  912. (voir §3.1) permet de sélectionner une séquence dès le démarrage. La chaine
  913. "option" sera analysée après les options d'appel. Si la séquence  spécifiée
  914. par l'option -C n'existe pas, cette option sera ignorée.
  915.  
  916.     Le fichier "S:APrf.Init" vous permet également  d'utiliser,  depuis
  917. APrf, les polices internes de votre imprimante. Pour cela, il  vous  suffit
  918. de rajouter une ligne de la forme :
  919.  
  920.     fontdef:nom:séquence
  921.  
  922. où "nom" est le nom de la police, et "séquence" la suite de  codes  faisant
  923. passer votre imprimante dans la police indiquée. Voici un exemple :
  924.  
  925.     fontdef:Prestige:27 107 2 27 120 49
  926.  
  927.     Le nombre de polices n'est pas limité. La sélection  de  la  police
  928. peut se faire soit à l'appel, à l'aide de l'option -I (voir §2.1),  soit  à
  929. l'aide du gadget "Police" (voir §2.4).  Il  est  conseillé  de  placer  les
  930. définitions de    police    en  début  de  fichier,  avant    la  définition    des
  931. configurations type.
  932.  
  933.     Vous pouvez également indiquer les couleurs à utiliser pour l'écran
  934. de APrf, avec une ligne de la forme :
  935.  
  936.     palette: c1 c2 c3 c4
  937.  
  938. où "c1", "c2", "c3" et "c4" sont les spécifications RVB de chaque  couleur.
  939. Vous pouvez indiquer ces valeurs en décimal ou en hexadécimal (dans ce cas,
  940. ajoutez "0x" devant la valeur, par  exemple  "0x0F00").  Si  vous  indiquez
  941. plusieurs palettes, seule la dernière sera prise en compte.
  942.  
  943.     APrf accepte des lignes vides dans le fichier. Une ligne commençant
  944. par un point-virgule (";") sera considérée comme un commentaire et ne  sera
  945. donc pas interprétée.
  946.     Le  fichier  "S:APrf.Init"  sera  rechargé  chaque  fois  que  vous
  947. sélectionnerez la commande "Options défaut" dans le menu "Outils". En  mode
  948. "eXpress" (voir §3.2), le fichier "S:APrf.Init" ne sera chargé qu'en cas de
  949. besoin, c'est-à-dire si vous indiquez une option -C ou -I. Notez enfin  que
  950. les séquences sont envoyées  par  une commande    PRD_RAWWRITE,  c'est-à-dire
  951. qu'elles ne seront pas interprétées par le pilote d'imprimante.
  952.  
  953.  
  954. 4. Gestion de la mémoire :
  955. --------------------------
  956.  
  957.     Ce chapitre explique comment APrf gère la mémoire qu'il utilise. Je
  958. vous conseille de le lire attentivement MEME SI AVEZ UNE EXTENSION MEMOIRE.
  959.  
  960.  
  961.     4.1 Le fichier à imprimer :
  962.     ---------------------------
  963.  
  964.     Avant d'imprimer ou de pré-visualiser un fichier,  APrf  le  charge
  965. entièrement en mémoire. Une fois le traitement    terminée,  le  fichier    est
  966. conservé en mémoire, ce qui permet  d'éviter  de  le  recharger  à  nouveau
  967. si vous demandez ensuite une impression ou une pré-visualisation de ce même
  968. fichier.
  969.     La mémoire occupée par le fichier est libérée automatiquement quand
  970. APrf est iconifié (voir §2.5), quand vous choisissez un nouveau  fichier  à
  971. imprimer (voir  §2.4),  ou  quand  vous  choisissez  la  commande  "Fichier
  972. suivant" du menu "Projet" (voir  §2.5).  Le  fichier  peut  également  être
  973. libéré (mais dans certains cas seulement) si vous  choisissez  la  commande
  974. "Options par  défaut" du menu "Outils".
  975.  
  976.     Vous pouvez forcer  APrf  à  charger  immédiatement  le  fichier  à
  977. imprimer avec la commande "Charge fichier" du menu "Outils". Si le  fichier
  978. était déjà présent en mémoire, il sera rechargé  quand    même.  Vous  pouvez
  979. également forcer APrf à libérer la mémoire occupée par le fichier  avec  la
  980. commande "Libère fichier" du menu "Outils".
  981.  
  982.     Pour vous permettre de savoir si le fichier est chargé    en  mémoire
  983. ou non, APrf affiche le caractère "*" à droite du nom du fichier  quand  il
  984. est chargé en mémoire.
  985.  
  986.     Ce mode de fonctionnement peut avoir deux inconvénients.
  987.     Le premier est que  le    fichier  occupe  de  la  mémoire  peut-être
  988. inutilement (je pense ici à ceux qui n'ont que 512 Ko de mémoire). Dans  ce
  989. cas, vous pouvez soit iconifier APrf (voir  §2.5, vous gagnez  en  plus  la
  990. mémoire occupée par le tampon de sortie, par quelques zones de travail,  et
  991. au moins 32 Ko de mémoire CHIP), soit utiliser la commande "Libère fichier"
  992. du menu "Outils".
  993.     Le second est que si vous modifiez le fichier  sur  disquette,    ces
  994. modifications pourraient ne pas être prises  en  compte,  puisque  APrf  ne
  995. recharge pas le fichier. Pour éviter cela, APrf essaye de  détecter  si  le
  996. fichier a été modifié depuis le dernier chargement en mémoire,    et  si    tel
  997. est le cas vous propose de le recharger.
  998.  
  999.  
  1000.     4.2 Le tampon de sortie :
  1001.     -------------------------
  1002.  
  1003.     APrf utilise un  tampon  de  sortie,  afin  de    réduire  le  nombre
  1004. d'ordres d'écriture. Avec un tampon d'un kilo-octets,  l'écriture  vers  un
  1005. fichier se fait au moins deux fois plus rapidement  qu'avec  les  premières
  1006. versions d'APrf, dont le tampon ne contenait qu'une ligne. L'écriture  vers
  1007. l'imprimante n'est pas accélérée de manière visible. Dans tous les cas,  le
  1008. nombre d'ordres d'écriture est divisé au  moins  par  5  (cela  peut  aller
  1009. jusqu'à 14 ou 15), ce qui réduit sensiblement la charge imposée au systême,
  1010. et PERMET AINSI DE MOINS RALENTIR LES AUTRES TACHES.
  1011.  
  1012.     Par défaut APrf utilise un tampon d'une page  (voir  §2.5  l'option
  1013. "Tampon 1Ko" du menu "Options"), afin de  réduire  encore  plus  le  nombre
  1014. d'ordres d'écriture. Quand vous changez la taille de la page, le tampon est
  1015. automatiquement ré-alloué pour pouvoir contenir une page entière. S'il  n'y
  1016. a plus assez de mémoire pour allouer un  tampon  d'une  page,  APrf  réduit
  1017. automatiquement la taille du tampon à un kilo-octets.
  1018.      S'il n'est pas possible d'allouer ce tampon d'un kilo-octets, APrf
  1019. s'arrête et affiche le message d'erreur "Plus de mémoire libre".
  1020.  
  1021.  
  1022.     4.3 Mémoire nécessaire :
  1023.     ------------------------
  1024.  
  1025.     Le chargement du programme en mémoire  et  l'ouverture  de  l'écran
  1026. (avec gadgets et menus) nécessitent un peu plus de 100 Ko. Toute  opération
  1027. sur le fichier    à  imprimer  (impression,  pré-visualisation,  "doc  info",
  1028. etc...) provoque le chargement de ce fichier en mémoire, l'allocation  d'un
  1029. tampon d'une page de (NombreDeLignes * LargeurDesLignes)  octets  pour   la
  1030. composition des pages. Une impression provoque de  plus  l'allocation  d'un
  1031. tampon de sortie,  d'une  page  ou  d'un  kilo-octet  (suivant  la  mémoire
  1032. disponible).
  1033.  
  1034.  
  1035. 5. Divers :
  1036. -----------
  1037.  
  1038.     Ce chapitre est un bric-à-brac de quelques  indications  qui  n'ont
  1039. pas trouvé place dans les autres paragraphes.  Il contient certains détails
  1040. importants  sur  le fonctionnement du programme.  Je vous conseille donc de
  1041. lire attentivement ce qui suit, au moins une fois, et de penser à le relire
  1042. si APrf vous semble se comporter de manière bizarre.
  1043.  
  1044.     Voici comment APrf réagit si l'option "Continu"  est  désactivée  :
  1045. avant d'envoyer une page à l'imprimante, une  boite  de  requête  apparait,
  1046. vous demandant d'introduire une nouvelle feuille dans  l'imprimante.  Quand
  1047. vous êtes prêt, cliquez sur "OUI" ou appuyez sur  Amiga-V  : la  page  sera
  1048. envoyée à l'imprimante. Si vous cliquez sur "NON", ou appuyez sur  Amiga-B,
  1049. l'impression sera abandonnée.
  1050.  
  1051.     Si  vous  désirez interrompre une impression, cliquez dans le cadre
  1052. où  est  affiché  le  numéro  de  l'exemplaire  et  de  la  page  en  cours
  1053. d'impression. Une boite de  requète  apparait  alors,  pour  vous  demander
  1054. confirmation : cliquez sur  "OUI"  ou  appuyez  sur  Amiga-V  pour  arrêter
  1055. l'impression, cliquez sur "NON"  ou  appuyez  sur  Amiga-B  pour  reprendre
  1056. l'impression.
  1057.     Si vous confirmez l'arrêt de l'impression, l'envoi  des  données  à
  1058. l'imprimante est alors suspendu, ce qui ne  veut  pas  forcément  dire  que
  1059. l'impression s'arrête tout de suite : il faut attendre que l'imprimante ait
  1060. vidé son tampon. Un message apparait pour vous informer que votre demande a
  1061. été prise en compte, et APrf attend que l'ordre d'écriture  en  cours  soit
  1062. terminé (cela peut prendre un certain temps !).
  1063.  
  1064.     Pour vous permettre d'améliorer la présentation de  vos  documents,
  1065. APrf reconnait les séquences ANSI suivantes :
  1066.  
  1067.         ESC[0m        caractères normaux
  1068.         ESC[3m        début d'italique
  1069.         ESC[23m     fin d'italique
  1070.         ESC[4m        début de souligné
  1071.         ESC[24m     fin de souligné
  1072.         ESC[1m        début de gras
  1073.         ESC[22m     fin de gras
  1074.         ESC[1"z         qualité listing
  1075.         ESC[2"z         qualité courrier
  1076.  
  1077.     Ces séquences sont envoyées à l'imprimante, mais les caractères qui
  1078. les composent ne sont pas pris en compte dans le calcul de la mise en page.
  1079. De même, ils n'apparaissent pas lors de la pré-visualisation.  Toute  autre
  1080. séquence ne sera pas reconnue, et sera considéré comme    faisant  partie  du
  1081. texte à imprimer. Vous pouvez filtrer ces séquences, si vous  ne  souhaitez
  1082. pas qu'elles soient envoyées à  l'imprimante  (voir  §2.5,  option  "Filtre
  1083. ANSI" du menu "Options").
  1084.     La taille de ces séquences est limitée à 32 caractères par LIGNE DE
  1085. SORTIE (et non par ligne du fichier à imprimer). Cela correspond à 6  ou  8
  1086. séquences, et devrait être suffisant dans la plupart des cas. S'il y a trop
  1087. de séquences sur une ligne de sortie,  le  message  d'erreur  "Lignes  trop
  1088. longues, impression abandonnée" apparaitra en cours d'impression.
  1089.  
  1090.     Sauf si le filtrage  des  caractères  de  contrôle  est  actif,  un
  1091. caractère "Saut de page" dans le fichier à imprimer provoquera un  saut  de
  1092. page lors de l'impression. Notez enfin que les caractères "Backspace" (code
  1093. ASCII 8) ne sont pas comptés lors de la composition des lignes.
  1094.  
  1095.